home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / nntpget.readme < prev    next >
Text File  |  1994-10-08  |  4KB  |  81 lines
  1. Short: NNTP client for AS225, polls server and makes a News batchfile
  2. Author:  Michael van Elst (mlelstv@serpens.rhein.de)
  3.  
  4. nntpget is a NNTP (Net News Transfer Protocol) client that gathers news
  5. articles from a remote NNTP server. It was written for AS225R2 but seems
  6. to work fine with AmiTCP and the faked socket.library done by Henning
  7. Schmiedehausen (also on Aminet).
  8.  
  9. What would you do when you do not have a working NNTP daemon or do not
  10. want to run (and let it write to disk) all the time ?
  11.  
  12. My solution is nntpget, a program that talks with a remote NNTP server
  13. using the 'newnews' and 'article' commands to query for new articles
  14. since a specific date and then to retrieve these articles. nntpget
  15. generates a valid batchfile suitable for 'rnews' or the like (i.e.
  16. including the #! rnews xxxx headers).
  17.  
  18. Usage:
  19.  
  20. > nntpget ?
  21. FROM/M,SUBSCRIPTIONS/K,ARTICLES/K,SINCE/K,TO/A/K,APPEND/S,NNTPSERVER/K/A,CPS/K/N: 
  22.  
  23.   FROM             multiple strings denoting newsgroups or complete hierarchies
  24.                    like:   FROM de.test  alt.*  news.announce
  25.   
  26.   SUBSCRIPTIONS    file with list of newsgroups or hierarchies, one per line
  27.  
  28.   ARTICLES         file with list of MsgIDs, one per line
  29.  
  30. you can use all 3 sources at the same time. nntpget will first work on FROM,
  31. then on SUBSCRIPTIONS then on ARTICLES.
  32.  
  33.   SINCE date       fetch only articles since given date in AmigaDOS format
  34.                    substitutes like 'monday' or 'yesterday' are valid meaning
  35.                    the last such weekday (at current time). So yesterday says
  36.                    to retrieve news from the last 24 hours.
  37.                    If you tell it the current day or 'today' this says to fetch
  38.                    all articles since this day at midnight.
  39.                    You can also specify a time meaning since today (or yesterday
  40.                    if the time would be in the future) at that time.
  41.  
  42.                    If you do not use the SINCE parameter the newserver is told
  43.                    to retrieve articles since 1.1.1900 (i.e. since ever). Some
  44.                    servers may interpret this as 1.1.2000 instead and won't send
  45.                    anything for a while.
  46.  
  47.   TO file          generated batch file
  48.  
  49.   APPEND           append to batch file
  50.  
  51.   NNTPSERVER       the name or IP number of your NNTP server machine
  52.  
  53.   CPS num          bandwidth limitation. nntpget tries to keep traffic below
  54.                    the given characters per second. This can only be an average
  55.                    since there are bursts of at least one TCP segment which
  56.                    are under control of the TCP protocol stack.
  57.                    The bandwidth is just limited for article transfers and not
  58.                    for the initial transfer of article MsgIDs but which is short.
  59.  
  60. nntpget uses 2 temporary files in T:. One to gather all MsgIDs, one for the
  61. current article (it cannot write directly to the batchfile since it doesn't know
  62. the size at that time which has to go to the #! rnews header). So please have
  63. enough space on that filesystem (usually T: is on RAM:).
  64.  
  65. While running nntpget will show you (part of) the NNTP traffic on stdout as well
  66. as the average transfer rate.
  67.  
  68. I hope this program is useful for someone else.
  69.  
  70. Michael van Elst
  71.  
  72.  
  73. ============================= Archive contents =============================
  74.  
  75. Original  Packed Ratio    Date     Time    Name
  76. -------- ------- ----- --------- --------  -------------
  77.     8880    5353 39.7% 27-May-94 14:10:06  nntpget
  78.     3263    1500 54.0% 27-May-94 14:35:16  nntpget.readme
  79. -------- ------- ----- --------- --------
  80.    12143    6853 43.5% 27-May-94 12:59:50   2 files
  81.